home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / rfileu10.zip / HD.DOC < prev    next >
Text File  |  1993-05-06  |  8KB  |  162 lines
  1.  
  2.  
  3.                                 #     # ###### 
  4.                                 #     # #     #
  5.                                 #     # #     #
  6.                                 ####### #     #
  7.                                 #     # #     #
  8.                                 #     # #     #
  9.                                 #     # ###### 
  10.  
  11.  
  12.  
  13.  
  14. You can get part of the following documentation by invoking the program with
  15. the switches -v, -h, or -H . See README.TXT for more information.
  16.  
  17. -----------------------------------   -v   ------------------------------------
  18. HD v1.0 -- Display hex dumps of binary files
  19. Copr (c) 1992,1993 Richard Breuer. HD is freeware. No warranties.
  20.  
  21. This is HD/2 v1.0 - renamed to HD (from RUTILS 4).
  22.  
  23. Author: Richard Breuer
  24.         Brunssumstrasse 6
  25.         5100 Aachen
  26.         (after Jul 1, 1993: 52074 Aachen)
  27.         Germany
  28.         Europe
  29.  
  30. Phone:  +49/241/85605
  31. Fax:    +49/241/8021329
  32.  
  33. Email:  ricki@pool.informatik.rwth-aachen.de (Preferred!)
  34.  
  35. -----------------------------------   -h   ------------------------------------
  36. HD v1.0 -- Display hex dumps of binary files
  37. Copr (c) 1992,1993 Richard Breuer. HD is freeware. No warranties.
  38.  
  39. Usage:
  40.    HD [-hHl:o:qtxv*] infile.. [{>|>>} outfile]
  41.  
  42. Options (+ are default):
  43.    -h    Display this help screen
  44.    -H    Display another help screen with notes and examples
  45.    -l<n> Display <n> lines with 16 bytes each for every file. If the first
  46.          character of <n> is $, <n> is interpreted as hex, default is decimal.
  47.          If <n> is omitted, n=20 (about one page) is assumed
  48. +  -n    Use normal charset (#32..#126, #128..#168)
  49.    -o<n> Start at file offset <n> (As with -l, $ may be used)
  50.    -q    Don't display header lines
  51.    -t    Use tiny charset (0..9, A..Z, a..z)
  52.    -x    Use extended charset (#32..#254)
  53.    -v    Display version info
  54.    -*    Display internal information (for debugging purposes)
  55.  
  56. -----------------------------------   -H   ------------------------------------
  57. HD v1.0 -- Display hex dumps of binary files
  58. Copr (c) 1992,1993 Richard Breuer. HD is freeware. No warranties.
  59.  
  60. Notes:
  61.    The output is always directed to stdout. The errorlevel is set to 1 if help
  62.    has been displayed. It is set to 255 in case of an error and 0 on normal
  63.    completion. Output resulting from multiple input files is appended to
  64.    stdout. The processing order for wildcards depends on the order of the
  65.    directory entries. Adresses are displayed with 4 digits. If they are longer,
  66.    the 4 LSB's are displayed. Console input is not possible. Piping works.
  67.  
  68. Example:
  69.    HD *.COM
  70.       Process all *.COM files in the current directory and append the hexdumps
  71.       to stdout. The order is the one DOS's DIR tells you.
  72.    MYPROG | HD -x > MYPROG.HEX
  73.       Creates a hex dump of the stuff MYPROG writes on stdout.
  74.  
  75. -------------------------------------------------------------------------------
  76. Additional information:
  77.    HD is similar to the Unix command OD, which has several useful options more
  78.    than HD. Maybe some day I'll re-implement OD, but until now HD serves me
  79.    well.
  80.  
  81. Example:
  82.    Here's an example. I ran HD with a little program called keyfake by Charles
  83.    Petzold, which I sometimes use:
  84.  
  85.    HD \BIN\KEYFAKE.COM            (normal character set)
  86.      File: \bin\KEYFAKE.COM
  87.      Addr   0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F  0123456789ABCDEF
  88.      -----------------------------------------------------------------------
  89.      0000  E9 83 00 4B 45 59 2D 46 41 4B 45 20 28 43 29 20  ...KEY-FAKE (C)
  90.      0010  43 6F 70 79 72 69 67 68 74 20 43 68 61 72 6C 65  Copyright Charle
  91.      0020  73 20 50 65 74 7A 6F 6C 64 2C 20 31 39 38 35 00  s Petzold, 1985.
  92.      0030  00 00 00 86 01 00 FB 2E 80 3E 35 01 00 74 09 0A  .........>5..t..
  93.      0040  E4 74 0A 80 FC 01 74 20 2E FF 2E 2F 01 53 2E 8B  .t....t .../.S..
  94.      0050  1E 33 01 2E 8B 07 43 43 2E 89 1E 33 01 2E FE 0E  .3....CC...3....
  95.      0060  35 01 5B 0B C0 74 CF CF 53 2E 8B 1E 33 01 2E 8B  5.[..t..S...3...
  96.      0070  07 5B 0B C0 75 0D 2E 83 06 33 01 02 2E FE 0E 35  .[..u....3.....5
  97.      0080  01 0B C0 CA 02 00 C7 06 00 01 00 00 C6 06 02 01  ................
  98.      0090  00 FC 8C CA 2B C0 8E C0 BE 00 01 8B FE B9 2F 00  ....+........./.
  99.      00A0  F3 A6 74 2C 40 8E C0 3B C2 75 ED C6 06 01 00 27  ..t,@..;.u.....'
  100.      00B0  2B C0 8E D8 A1 58 00 2E A3 2F 01 A1 5A 00 2E A3  +....X.../..Z...
  101.      00C0  31 01 FA C7 06 58 00 36 01 8C 0E 5A 00 FB 0E 1F  1....X.6...Z....
  102.      00D0  BE 80 00 BF 86 01 26 89 3E 33 01 26 C6 06 35 01  ......&.>3.&..5.
  103.      00E0  00 AC 98 8B C8 41 0B C0 75 03 E9 27 01 E9 9B 00  .....A..u..'....
  104.      00F0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................
  105.      [...]
  106.      0200  06 87 02 00 C6 06 88 02 00 C6 06 89 02 00 49 74  ..............It
  107.      0210  03 E9 77 FF BA 86 02 C3                          ..w.....
  108.  
  109.      Total: 34 lines with 536 bytes.
  110.  
  111.    HD \BIN\KEYFAKE.COM -x        (extended character set)
  112.      File: \bin\KEYFAKE.COM
  113.      Addr   0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F  0123456789ABCDEF
  114.      -----------------------------------------------------------------------
  115.      0000  E9 83 00 4B 45 59 2D 46 41 4B 45 20 28 43 29 20  Θâ.KEY-FAKE (C)
  116.      0010  43 6F 70 79 72 69 67 68 74 20 43 68 61 72 6C 65  Copyright Charle
  117.      0020  73 20 50 65 74 7A 6F 6C 64 2C 20 31 39 38 35 00  s Petzold, 1985.
  118.      0030  00 00 00 86 01 00 FB 2E 80 3E 35 01 00 74 09 0A  ...å..√.Ç>5..t..
  119.      0040  E4 74 0A 80 FC 01 74 20 2E FF 2E 2F 01 53 2E 8B  Σt.Çⁿ.t . ./.S.ï
  120.      0050  1E 33 01 2E 8B 07 43 43 2E 89 1E 33 01 2E FE 0E  .3..ï.CC.ë.3..■.
  121.      0060  35 01 5B 0B C0 74 CF CF 53 2E 8B 1E 33 01 2E 8B  5.[.└t╧╧S.ï.3..ï
  122.      0070  07 5B 0B C0 75 0D 2E 83 06 33 01 02 2E FE 0E 35  .[.└u..â.3...■.5
  123.      0080  01 0B C0 CA 02 00 C7 06 00 01 00 00 C6 06 02 01  ..└╩..╟.....╞...
  124.      0090  00 FC 8C CA 2B C0 8E C0 BE 00 01 8B FE B9 2F 00  .ⁿî╩+└Ä└╛..ï■╣/.
  125.      00A0  F3 A6 74 2C 40 8E C0 3B C2 75 ED C6 06 01 00 27  ≤ªt,@Ä└;┬uφ╞...'
  126.      00B0  2B C0 8E D8 A1 58 00 2E A3 2F 01 A1 5A 00 2E A3  +└Ä╪íX..ú/.íZ..ú
  127.      00C0  31 01 FA C7 06 58 00 36 01 8C 0E 5A 00 FB 0E 1F  1.·╟.X.6.î.Z.√..
  128.      00D0  BE 80 00 BF 86 01 26 89 3E 33 01 26 C6 06 35 01  ╛Ç.┐å.&ë>3.&╞.5.
  129.      00E0  00 AC 98 8B C8 41 0B C0 75 03 E9 27 01 E9 9B 00  .¼ÿï╚A.└u.Θ'.Θ¢.
  130.      00F0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................
  131.      [...]
  132.      0200  06 87 02 00 C6 06 88 02 00 C6 06 89 02 00 49 74  .ç..╞.ê..╞.ë..It
  133.      0210  03 E9 77 FF BA 86 02 C3                          .Θw ║å.├
  134.  
  135.      Total: 34 lines with 536 bytes.
  136.  
  137.    HD \BIN\KEYFAKE.COM -t        (tiny character set)
  138.      File: \bin\KEYFAKE.COM
  139.      Addr   0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F  0123456789ABCDEF
  140.      -----------------------------------------------------------------------
  141.      0000  E9 83 00 4B 45 59 2D 46 41 4B 45 20 28 43 29 20  ...KEY.FAKE..C..
  142.      0010  43 6F 70 79 72 69 67 68 74 20 43 68 61 72 6C 65  Copyright.Charle
  143.      0020  73 20 50 65 74 7A 6F 6C 64 2C 20 31 39 38 35 00  s.Petzold..1985.
  144.      0030  00 00 00 86 01 00 FB 2E 80 3E 35 01 00 74 09 0A  ..........5..t..
  145.      0040  E4 74 0A 80 FC 01 74 20 2E FF 2E 2F 01 53 2E 8B  .t....t......S..
  146.      0050  1E 33 01 2E 8B 07 43 43 2E 89 1E 33 01 2E FE 0E  .3....CC...3....
  147.      0060  35 01 5B 0B C0 74 CF CF 53 2E 8B 1E 33 01 2E 8B  5....t..S...3...
  148.      0070  07 5B 0B C0 75 0D 2E 83 06 33 01 02 2E FE 0E 35  ....u....3.....5
  149.      0080  01 0B C0 CA 02 00 C7 06 00 01 00 00 C6 06 02 01  ................
  150.      0090  00 FC 8C CA 2B C0 8E C0 BE 00 01 8B FE B9 2F 00  ................
  151.      00A0  F3 A6 74 2C 40 8E C0 3B C2 75 ED C6 06 01 00 27  ..t......u......
  152.      00B0  2B C0 8E D8 A1 58 00 2E A3 2F 01 A1 5A 00 2E A3  .....X......Z...
  153.      00C0  31 01 FA C7 06 58 00 36 01 8C 0E 5A 00 FB 0E 1F  1....X.6...Z....
  154.      00D0  BE 80 00 BF 86 01 26 89 3E 33 01 26 C6 06 35 01  .........3....5.
  155.      00E0  00 AC 98 8B C8 41 0B C0 75 03 E9 27 01 E9 9B 00  .....A..u.......
  156.      00F0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................
  157.      [...]
  158.      0200  06 87 02 00 C6 06 88 02 00 C6 06 89 0